fix(astro): Automatically use CSR Show component for prerendered pages by wobsoriano · Pull Request #7710 · clerk/javascript

wobsoriano · 2026-01-30T01:49:53Z

Description

Port of #7708 but using the <Show> component

Checklist

pnpm test runs as expected.
pnpm build runs as expected.
(If applicable) JSDoc comments have been added or updated for any package exports
(If applicable) Documentation has been updated

Type of change

Summary by CodeRabbit

Bug Fixes
- Fixed an error when using Clerk Control components on prerendered pages to improve compatibility with static builds.
New Features
- Added a prerendered example page and a new "Prerendered Page" card in the signed-in UI to demonstrate prerendered behavior and client-side reveal.
Tests
- Added end-to-end tests validating signed-out and signed-in states on prerendered pages.
Chores
- Added a changeset for a patch release.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

…pages

changeset-bot · 2026-01-30T01:49:58Z

🦋 Changeset detected

Latest commit: 59a0875

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@clerk/astro	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

vercel · 2026-01-30T01:49:58Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
clerk-js-sandbox	Ready	Preview, Comment	Jan 31, 2026 5:32am

pkg-pr-new · 2026-01-30T01:53:18Z

Open in StackBlitz

@clerk/agent-toolkit

npm i https://pkg.pr.new/@clerk/agent-toolkit@7710

@clerk/astro

npm i https://pkg.pr.new/@clerk/astro@7710

@clerk/backend

npm i https://pkg.pr.new/@clerk/backend@7710

@clerk/chrome-extension

npm i https://pkg.pr.new/@clerk/chrome-extension@7710

@clerk/clerk-js

npm i https://pkg.pr.new/@clerk/clerk-js@7710

@clerk/dev-cli

npm i https://pkg.pr.new/@clerk/dev-cli@7710

@clerk/expo

npm i https://pkg.pr.new/@clerk/expo@7710

@clerk/expo-passkeys

npm i https://pkg.pr.new/@clerk/expo-passkeys@7710

@clerk/express

npm i https://pkg.pr.new/@clerk/express@7710

@clerk/fastify

npm i https://pkg.pr.new/@clerk/fastify@7710

@clerk/localizations

npm i https://pkg.pr.new/@clerk/localizations@7710

@clerk/nextjs

npm i https://pkg.pr.new/@clerk/nextjs@7710

@clerk/nuxt

npm i https://pkg.pr.new/@clerk/nuxt@7710

@clerk/react

npm i https://pkg.pr.new/@clerk/react@7710

@clerk/react-router

npm i https://pkg.pr.new/@clerk/react-router@7710

@clerk/shared

npm i https://pkg.pr.new/@clerk/shared@7710

@clerk/tanstack-react-start

npm i https://pkg.pr.new/@clerk/tanstack-react-start@7710

@clerk/testing

npm i https://pkg.pr.new/@clerk/testing@7710

@clerk/ui

npm i https://pkg.pr.new/@clerk/ui@7710

@clerk/upgrade

npm i https://pkg.pr.new/@clerk/upgrade@7710

@clerk/vue

npm i https://pkg.pr.new/@clerk/vue@7710

commit: 59a0875

coderabbitai · 2026-01-30T01:54:47Z

📝 Walkthrough

Walkthrough

Adds a changeset documenting a patch release for @clerk/astro. Modifies packages/astro/src/astro-components/control/Show.astro to decide CSR vs SSR based on an optional isStatic prop or runtime detection of Astro.locals.auth, introducing shouldUseCSR and hasShowFallback and updated slot fallback logic. Adds a prerendered page (export const prerender = true) at integration/templates/astro-node/src/pages/prerendered.astro and a linking card in the index. Adds a test case (duplicated insertion) verifying Show behavior on prerendered pages for signed-out and signed-in flows.

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 inconclusive)

Check name	Status	Explanation	Resolution
Linked Issues check	❓ Inconclusive	The linked issue CORE-3 provides no actionable coding requirements or acceptance criteria; it only states the fix was intentional, making compliance assessment impossible.	Clarify the linked issue with specific coding requirements, acceptance criteria, or functional expectations to enable proper validation.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly describes the main change: making the Show component automatically use CSR on prerendered pages, which aligns with the code modifications to Show.astro component logic.
Out of Scope Changes check	✅ Passed	All changes (Show.astro logic, new prerendered test page, test cases, and changeset) are directly related to enabling the Show component to work correctly on prerendered pages.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

coderabbitai

Actionable comments posted: 1

🤖 Fix all issues with AI agents

In `@packages/astro/src/astro-components/control/Show.astro`:
- Around line 25-28: Guard access to Astro.locals.auth when computing
shouldUseCSR to avoid crashes on prerendered pages: change the logic that sets
shouldUseCSR (currently using isStatic !== undefined ? isStaticOutput(isStatic)
: !Astro.locals.auth) to first detect prerendered context (e.g., via
isPrerenderedPage or by checking Astro.locals existence) and only read
Astro.locals.auth when safe; keep the fallback to isStaticOutput(isStatic) when
isStatic is provided and preserve selecting ShowComponent = shouldUseCSR ?
ShowCSR : ShowSSR. Also add unit/integration tests that verify Show renders with
CSR when runtime auth is present, with SSR when not, and that prerendered pages
do not throw when Astro.locals is undefined.

packages/astro/src/astro-components/control/Show.astro

jacekradko

wobsoriano added 2 commits January 29, 2026 17:46

chore: add changeset

dc35671

fix(astro): Automatically use CSR control components for prerendered …

e8a7e0c

…pages

github-actions bot added astro core-3 labels Jan 30, 2026

coderabbitai bot reviewed Jan 30, 2026

View reviewed changes

packages/astro/src/astro-components/control/Show.astro Show resolved Hide resolved

chore: adapt prerendered tests to use Show component

9afbe03

github-actions bot added the integration label Jan 30, 2026

chore: add changeset

fc04fe3

vercel bot deployed to Preview January 30, 2026 02:00 View deployment

wobsoriano changed the title ~~fix(astro): Automatically use CSR control components for prerendered pages~~ fix(astro): Automatically use CSR Show component for prerendered pages Jan 30, 2026

fix: guard Astro.locals

1cd67a7

vercel bot temporarily deployed to Preview January 30, 2026 04:29 Inactive

Merge branch 'main' into rob/fix-astro-prerendered-core-3

53495be

vercel bot deployed to Preview January 30, 2026 17:16 View deployment

jacekradko approved these changes Jan 30, 2026

View reviewed changes

wobsoriano enabled auto-merge (squash) January 30, 2026 18:22

Merge branch 'main' into rob/fix-astro-prerendered-core-3

59a0875

vercel bot deployed to Preview January 31, 2026 05:32 View deployment

wobsoriano merged commit cdcabb9 into main Jan 31, 2026
38 checks passed

wobsoriano deleted the rob/fix-astro-prerendered-core-3 branch January 31, 2026 05:38

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

fix(astro): Automatically use CSR Show component for prerendered pages#7710

fix(astro): Automatically use CSR Show component for prerendered pages#7710
wobsoriano merged 7 commits intomainfrom
rob/fix-astro-prerendered-core-3

wobsoriano commented Jan 30, 2026 •

edited by coderabbitai bot

Loading

Uh oh!

changeset-bot bot commented Jan 30, 2026 •

edited

Loading

Uh oh!

vercel bot commented Jan 30, 2026 •

edited

Loading

Uh oh!

pkg-pr-new bot commented Jan 30, 2026 •

edited

Loading

Uh oh!

coderabbitai bot commented Jan 30, 2026 •

edited

Loading

Walkthrough

Uh oh!

coderabbitai bot left a comment

Uh oh!

Uh oh!

jacekradko left a comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

wobsoriano commented Jan 30, 2026 • edited by coderabbitai bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Checklist

Type of change

Summary by CodeRabbit

Uh oh!

changeset-bot bot commented Jan 30, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

vercel bot commented Jan 30, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

pkg-pr-new bot commented Jan 30, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

coderabbitai bot commented Jan 30, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Walkthrough

Uh oh!

coderabbitai bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

jacekradko left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

wobsoriano commented Jan 30, 2026 •

edited by coderabbitai bot

Loading

changeset-bot bot commented Jan 30, 2026 •

edited

Loading

vercel bot commented Jan 30, 2026 •

edited

Loading

pkg-pr-new bot commented Jan 30, 2026 •

edited

Loading

coderabbitai bot commented Jan 30, 2026 •

edited

Loading